home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / acos.z / acos
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  90 lines
  1. ACOS(3I)                                              Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      AACCOOSS, DDAACCOOSS, QQAACCOOSS, AACCOOSSDD, DDAACCOOSSDD, QQAACCOOSSDD - Computes arc cosine
  6.      (inverse cosine)
  7.  
  8. SSYYNNOOPPSSIISS
  9.      AACCOOSS (([XX==]_x))
  10.      DDAACCOOSS (([XX==]_x))
  11.      QQAACCOOSS (([XX==]_x))
  12.  
  13.      AACCOOSSDD (([XX==]_x))
  14.      DDAACCOOSSDD (([XX==]_x))
  15.      QQAACCOOSSDD (([XX==]_x))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      UNICOS, UNICOS/mk, IRIX systems
  19.  
  20.      CF90, MIPSpro 7 Fortran 90, MIPSpro Fortran 77
  21.  
  22. SSTTAANNDDAARRDDSS
  23.      Fortran
  24.  
  25.      Fortran extensions:  QQAACCOOSS, AACCOOSSDD, DDAACCOOSSDD, QQAACCOOSSDD
  26.  
  27. DDEESSCCRRIIPPTTIIOONN
  28.      AACCOOSS, DDAACCOOSS, and QQAACCOOSS return the arc cosine in radians.  AACCOOSSDD,
  29.      DDAACCOOSSDD, and QQAACCOOSSDD return the arc cosine in degrees.  AACCOOSS and AACCOOSSDD
  30.      are generic function names; the others are specifics.  These are
  31.      elemental intrinsic functions.  These routines accept the following
  32.      argument:
  33.  
  34.      _x         Must be of type single precision, double precision, or quad
  35.                precision.  The type and kind type of _x is identical to the
  36.                type and kind type of the return value.  The absolute value
  37.                of the arguments for AACCOOSS, DDAACCOOSS, QQAACCOOSS, AACCOOSSDD, DDAACCOOSSDD, and
  38.                QQAACCOOSSDD must be <= 1.  See the RETURN VALUES section for
  39.                information on input data types and return values.
  40.  
  41.                The data type and kind type for single-precision,
  42.                double-precision, and quad-precision values differ depending
  43.                on your platform.  For platform-specific information, see
  44.                the TERMINOLOGY section of the IINNTTRROO__IINNTTRRIINN(3I) man page.
  45.  
  46.      For AACCOOSS, DDAACCOOSS, and QQAACCOOSS, the result is in radians and is in the
  47.      range 0 <= _r_e_s_u_l_t <= pi.  The generic form, AACCOOSS, can be used for all
  48.      real data types because it derives its type and kind type from that of
  49.      its argument.
  50.  
  51.      For AACCOOSSDD, DDAACCOOSSDD, and QQAACCOOSSDD, the result is in degrees and is in the
  52.      range 0 <= _r_e_s_u_l_t <= 180.  The generic form, AACCOOSSDD, can be used for
  53.      all real data types because it derives its type and kind type from
  54.      that of its argument.
  55.  
  56.      Vector versions of these intrinsics exist on some systems.  Vector
  57.      versions of AACCOOSS and DDAACCOOSS exist on UNICOS and UNICOS/mk systems.  On
  58.      UNICOS/mk systems, the vector versions of these intrinsics are used
  59.      when --OO vveeccttoorr33 or --OO33 has been specified on the compiler command
  60.      line.  On UNICOS/mk systems, the 64-bit intrinsic vectorizes; the
  61.      32-bit version does not.  A vector version of the single-precision and
  62.      double-precision AACCOOSS intrinsic exists on IRIX systems and is used
  63.      when --OO33 is specified on the compiler command line.
  64.  
  65.      These functions evaluate _y = arccos(_x).
  66.  
  67. NNOOTTEESS
  68.      The AACCOOSS and DDAACCOOSS intrinsic function names can be passed as
  69.      arguments; the others cannot.
  70.  
  71.      On CRAY T90 systems that support IEEE arithmetic, the following return
  72.      value occurs:
  73.  
  74.                AACCOOSS((_x)=NaN if |_x| > 1.0 or if _x = NaN
  75.  
  76. RREETTUURRNN VVAALLUUEESS
  77.      AACCOOSS and AACCOOSSDD return the real arc cosine of their real arguments.
  78.  
  79.      DDAACCOOSS and DDAACCOOSSDD return the double-precision arc cosine of their
  80.      double-precision arguments.
  81.  
  82.      QQAACCOOSS and QQAACCOOSSDD return the quad-precision arc cosine of their
  83.      quad-precision arguments.
  84.  
  85. SSEEEE AALLSSOO
  86.      iinnttrroo__iinnttrriinn(3I)
  87.  
  88.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  89.      man page.
  90.